home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dvexec.arc / DVEXEC.DOC < prev    next >
Text File  |  1989-03-11  |  5KB  |  105 lines
  1. DVEXEC
  2. Copyright (C) 1989 George A. Stanislav
  3. All rights reserved
  4.  
  5. This program is an extension and generalization of my DVRUN. Both programs
  6. achieve the same goal but in slightly different manner.
  7.  
  8. DVRUN is a .BIN file which needs to be combined with a DESQview PIF file,
  9. thus creating a seaparate .COM program for each and every program it loads.
  10. Its advantage is that a copy of the PIF file is no longer necessary to be
  11. kept on the system (unless you still want to be able to run the program
  12. manually from DESQview menu). Furthermore, DVRUN does not need to open and
  13. read the file, thus being faster and saving a file handle.
  14.  
  15. DVRUN is available separatly from various BBS.
  16.  
  17. On the other hand, DVEXEC offers more flexibility in that a single program
  18. can open a DESQview window for any program currently installed to run under
  19. DESQview. As a matter of fact it will even run programs not yet installed,
  20. as long as there is a PIF available somewhere on the system.
  21.  
  22. DVEXEC allows you load and run programs in another window from a batch file.
  23. This is of great advantage especially to sysops of electronic bulletin board
  24. systems who often need to run a program at a certain specific time unattended.
  25. Under usual circumstances they use a batch file which runs the program while
  26. their BBS is waiting idle.
  27.  
  28. With DVEXEC you can run such programs in another DESQview window and return
  29. to BBS program while doing that. Of course, DVEXEC is not limited to operators
  30. of BBS.
  31.  
  32. How does it work? Simply type DVEXEC followed by the name of the PIF control-
  33. ling the program you want to run. Typically, your PIF will be in the C:\DV
  34. directory. Its name will usually be two characters, followed by a dash, 'PIF',
  35. dot and the 'DVP' extension.
  36.  
  37. For example, the DOS Services program will most likely be defined in
  38. C:\DV\DS-PIF.DVP. To run it from a batch file, place the following line in
  39. the batch file:
  40.  
  41.                 DVEXEC C:\DV\DS-PIF.DVP
  42.  
  43. Please note that the command is case insensitive. You can use any combination
  44. of lower and upper case.
  45.  
  46. When DVEXEC runs, it first shrinks its own memory to mere two kilobytes so as
  47. not to take up too much of the system resourses.
  48.  
  49. Then it will check if DESQview is loaded. If not, it will post a message on
  50. your screen and exit with errorlevel 1.
  51.  
  52. If it finds DESQview, it will open the PIF, read it and tell DESQview to open
  53. a window defined in the PIF.
  54.  
  55. There are several possible problems DVEXEC can encounter, besides DESQview
  56. not being loaded as mentioned above. The PIF may not be on the system or it
  57. may be impossible to open or read the PIF. Last but not least, DESQview may
  58. not be able to open another window, typically because non-swappable windows
  59. are in the way.
  60.  
  61. In all the above cases, DVEXEC will post a message on the screen and will exit
  62. with an errorlevel. The messages can be redirected to a file for later
  63. examination, for example like this:
  64.  
  65.                 DVEXEC C:\DV\D1-PIF.DVP >> C:\DV\DVEXEC.LOG
  66.  
  67. Note that you need a double >>, or else each time you run the program the
  68. log will be overwritten.
  69.  
  70. If DVEXEC and DESQview are successful, DVEXEC will inform you and will print
  71. the task handle on the screen. This message, of course, can be redirected as
  72. all others. DVEXEC will then exit with errorlevel 0.
  73.  
  74. Here is a list of errorlevels which can be acted upon by your batch file:
  75.  
  76.         - Success:                      0
  77.         - DESQview not loaded:          1
  78.         - No PIF specified:             1
  79.         - PIF not found:                1
  80.         - Can't open PIF:               1
  81.         - Can't read PIF:               1
  82.         - DESQview cannot run PIF:      2
  83.  
  84. Simplified: Success = 0, non-DESQview related problem = 1, DESQview
  85. related problem = 2.
  86.  
  87. Please note that batch files look for errorlevel equal to OR greater than
  88. requested. Thus your batch file should check for errorlevel 2 first, 1 second,
  89. then default to 0 (success).
  90.  
  91. One final note: Once DVEXEC loads a program, it has no more control over it.
  92. It will not be able to close the window it has opened. For that reason, you
  93. should either use it with programs you have configured to close their window
  94. when done, or programs running from a batch file ending with the EXIT line,
  95. or finally programs you do not want to close.
  96.  
  97. LICENSE: This program may be freely distributed as long as there is no charge
  98. connected with the ditribution. Companies that sell public domain and
  99. shareware programs are expressly prohibited from distributing this program.
  100. This program is NOT in public domain, the author retains all the rights to
  101. this program, including the right to have the program taken out of public
  102. distribution.
  103.  
  104.  
  105.